package com.example.forum_system.service;

import com.example.forum_system.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: Li_Xiaochi
 * Date: 2025/4/27
 * Time: 10:50
 */
public interface IArticleService {

    /**
     * 发布帖子
     * @param article 要发布的帖子
     */
    @Transactional // 当前方法中的执行过程会被事务管理起来
    void create(Article article);

    /**
     * 查询所有的帖子列表
     * @return
     */
    List<Article> selectAll();

    /**
     * 查询所有的帖子列表
     * @return
     */
    List<Article> selectAllByPage(Integer offset, Integer size);

    /**
     * 根据版块 id 查询所有的帖子列表
     * @param boardId 版块 id
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * 根据版块 id 查询所有的帖子列表
     * @param boardId 版块 id
     * @return
     */
    List<Article> selectAllByBoardIdAndPage(Long boardId, Integer offset, Integer size);

    /**
     * 根据帖子 id 查询详情
     * @param id 帖子 Id
     * @return
     */
    Article selectDetailById(Long id);

    /**
     * 根据帖子 id 查询记录
     * @param id 帖子 id
     * @return
     */
    Article selectById(Long id);

    /**
     * 编辑帖子
     * @param id 帖子 id
     * @param title 帖子标题
     * @param content 帖子内容
     */
    void modify(Long id, String title, String content);

    /**
     * 点赞帖子
     * @param id 帖子id
     */
    void thumbsUpById(Long id);

    /**
     * 根据 ID 删除帖子
     * @param id 帖子 id
     */
    @Transactional // 事务管理
    void deleteById(Long id);

    /**
     * 更新文章回复数量 + 1
     * @param id 板块 Id
     */
    void addOneReplyCountById(Long id);

    /**
     * 根据用户Id查询帖子列表
     * @param userId 用户Id
     * @return
     */
    List<Article> selectByUserId(Long userId);

}
